Module Architecture

flowchart TD
    SUBSMOD["sadeem_subscription\nSubscription Base"]

    PKG["sadeem.subscription.trial.package\npackage config · duration\nresource limits · trial type"]
    LIM["sadeem.subscription.trial.model.limit\nper-model record limits\nfor trial package"]
    REQ["sadeem.subscription.trial.requests\ntrial request from customer\ncompany · email · mobile"]
    SUB["sadeem.subscription\ncreated from approved request"]
    WEB[/public trial form\n/saas/trial or /saas/trial/url/]

    SUBSMOD --> SUB

    PKG --> LIM
    WEB --> REQ
    REQ --> PKG

    PKG --> A1([define_auto_run\nauto-create + confirm subscription])
    PKG --> A2([success_message\ncustomizable per-package message])

    REQ --> A3([action_create_subscription\ncreate sadeem.subscription from request])
    REQ --> A4([action_create_partner\ncreate res.partner from request data])
    REQ --> A5([action_confirm\napprove request → trigger auto-run])
    REQ --> A6([action_reject\nreject trial request])

    A3 --> SUB
    A4 --> REQ

    CTRL[/website controller\n/saas/trial route/]
    WEB --> CTRL
    CTRL --> REQ

Module Description

SAAS Subscription Trial - Allows potential customers to request trial subscriptions through a public website form. Supports customizable trial packages with configurable duration, resource limits, and automatic subscription creation.

Dependencies

• base, web, mail, website
• sadeem_subscription

Menus

Website
└─ Trial Subscriptions
    ├─ Trial Packages
    └─ Trial Requests

Trial Flow

Customer fills form → Trial Request created → Partner created → Subscription created → Build & Run

1. Customer visits /saas/trial or /saas/trial/<package-url>
2. Fills out the trial form (name, company, email, mobile, company size)
3. System creates a trial request record and a partner record
4. If Auto Run Subscription is enabled on the package, the subscription is automatically created, confirmed, and queued for deployment
5. Customer sees a success message (customizable per package)

Key Fields

Trial Package (sadeem.subscription.trial.package)

Trial Model Limit (sadeem.subscription.trial.model.limit)

Trial Request (sadeem.subscription.trial.requests)

Subscription — Trial additions (sadeem.subscription inherit)

Lifecycle & States

Trial Request States

Transitions: - new → processing → done: action_create_subscription creates the subscription; if auto_run_subscription is True, also confirms and queues deployment - new → cancelled: action_cancel - cancelled → new: action_reset_to_new

Key Actions

Warnings & Important Notes

• Subscription creation blocked: action_create_subscription raises ValidationError if state is not new or processing, or if a subscription already exists for the request.
• Cannot cancel completed requests: action_cancel raises ValidationError if state is done.
• Can only reset cancelled requests: action_reset_to_new raises ValidationError if state is not cancelled.
• SQL constraint on email: _sql_constraints enforces unique email per trial request (prevents duplicate submissions).
• Trial duration required: trial_duration is required=True on the trial package.
• User and storage limits required: Both user_limit and storage_limit are required=True on the trial package.